[material_ui] [cupertino_ui] Add missing Widget of the Week videos to widget API docs by piedcipher · Pull Request #12468 · flutter/packages

piedcipher · 2026-08-13T20:38:43Z

Add missing Widget of the Week videos to widget API docs.

Audited all 181 videos and added missing ones in the docs.

Fixes github.com/flutter/flutter/issues/191031

Also check flutter/flutter#191070

Pre-Review Checklist

If you need help, consider asking for advice on the #hackers-new channel on Discord.

Note: The Flutter team is currently trialing the use of Gemini Code Assist for GitHub. Comments from the gemini-code-assist bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed.

Regular contributors who have demonstrated familiarity with the repository guidelines only need to comment if the PR is not auto-exempted by repo tooling. ↩ ↩²

gemini-code-assist

Code Review

This pull request updates the documentation for several widgets in the cupertino_ui and material_ui packages by adding missing "Widget of the Week" YouTube video links. It also bumps the package versions to 1.0.1 and updates their respective changelogs. I have no feedback to provide.

Piinks

Hey @piedcipher thanks for porting these over so quick!
I forgot, @youtube does not work outside of flutter/flutter, but is should soon: dart-lang/pub-dev#9490 (comment)

We worked around this for now in these packages by just embedding the link to the widget videos in the text, e.g.:

packages/packages/cupertino_ui/lib/src/activity_indicator.dart

Line 22 in a3e763e

    
           /// Learn more about [CupertinoActivityIndicator] on the [Flutter YouTube channel](https://www.youtube.com/watch?v=AENVH-ZqKDQ).

On another note, these packages are using a new batch release process to prevent the bottleneck of constant merge conflicts with the pubspec and changelog. Instead, you can create a pending changelog, and then we compile them together when the release goes out. There are instructions on adding the pending changelog file in flutter/flutter#188444 under "The flutter/packages changelog file". You can use the tool to create one, or you can create the file yourself using the template under pending_changelogs/

piedcipher · 2026-08-13T21:34:07Z

Thanks! I’ve done all of that. Appreciate the help!

gemini-code-assist

Code Review

This pull request adds links to Widget of the Week YouTube videos within the API documentation for CupertinoSliverNavigationBar, Badge, CarouselView, SearchAnchor, SearchBar, and SegmentedButton. It also adds corresponding changelog files for the cupertino_ui and material_ui packages. There are no review comments, and I have no feedback to provide.

jmagman

Confirmed all the links are pointed to the correct videos!

) Add missing Widget of the Week videos to widget API docs. <img width="1512" height="982" alt="Screenshot 2026-08-14 at 12 50 04 AM" src="https://github.com/user-attachments/assets/b3a2072e-4b4d-4ad7-baa7-50baf9aeed15" /> Audited all [181](https://www.youtube.com/playlist?list=PLjxrf2q8roU23XGwz3Km7sQZFTdB996iG) videos and added missing ones in the docs.  Fixes flutter#191031 Also check flutter/packages#12468 ## Pre-launch Checklist - [x] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [x] I read the [AI contribution guidelines] and understand my responsibilities, or I am not using AI tools. - [x] I read the [Tree Hygiene] wiki page, which explains my responsibilities. - [x] I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement]. - [x] I signed the [CLA]. - [x] I listed at least one issue that this PR fixes in the description above. - [x] I updated/added relevant documentation (doc comments with `///`). - [ ] I added new tests to check the change I am making, or this PR is [test-exempt]. - [x] I followed the [breaking change policy] and added [Data Driven Fixes] where supported. - [x] All existing and new tests are passing. If you need help, consider asking for advice on the #hackers-new channel on [Discord]. If this change needs to override an active code freeze, provide a comment explaining why. The code freeze workflow can be overridden by code reviewers. See pinned issues for any active code freezes with guidance. **Note**: The Flutter team is currently trialing the use of [Gemini Code Assist for GitHub](https://developers.google.com/gemini-code-assist/docs/review-github-code). Comments from the `gemini-code-assist` bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed.  [Contributor Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview [AI contribution guidelines]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#ai-contribution-guidelines [Tree Hygiene]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md [test-exempt]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests [Flutter Style Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md [Features we expect every widget to implement]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement [CLA]: https://cla.developers.google.com/ [flutter/tests]: https://github.com/flutter/tests [breaking change policy]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes [Discord]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md [Data Driven Fixes]: https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md

…tino_ui and material_ui

…ing_wotw_links.yaml

Piinks

LGTM!

auto-submit · 2026-08-19T23:53:11Z

autosubmit label was removed for flutter/packages/12468, because - The status or check suite Dashboard Checks has failed. Please fix the issues identified (or deflake) before re-applying this label.

…sing_wotw_links.yaml

…r#191480) flutter/packages@1785501...252bb33 2026-08-20 pateltirth454@gmail.com [material_ui] A typo in the README file of the package. (flutter/packages#12526) 2026-08-20 jmccandless@google.com [material_ui] Animated theme test from flutter/flutter (flutter/packages#12487) 2026-08-20 fluttergithubbot@gmail.com Sync release-material_ui-1.0.1 to main (flutter/packages#12513) 2026-08-20 pateltirth454@gmail.com [material_ui] [cupertino_ui] Add missing Widget of the Week videos to widget API docs (flutter/packages#12468) 2026-08-20 43054281+camsim99@users.noreply.github.com [camera_android_camerax] Add agentic guidance for adding native unit tests (flutter/packages#12369) 2026-08-20 21270878+elliette@users.noreply.github.com [material_ui] SearchAnchor overlay expands to full screen when viewport size changes (flutter/packages#12466) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages-flutter-autoroll Please CC flutter-ecosystem@google.com on the revert to ensure that a human is aware of the problem. To file a bug in Flutter: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md

piedcipher self-assigned this Aug 13, 2026

piedcipher changed the title ~~Add missing Widget of the Week videos to widget API docs~~ [material_ui] [cupertino_ui] Add missing Widget of the Week videos to widget API docs Aug 13, 2026

piedcipher requested review from Piinks and jmagman August 13, 2026 20:39

github-actions Bot added triage-framework Should be looked at in framework triage p: cupertino_ui p: material_ui labels Aug 13, 2026

piedcipher mentioned this pull request Aug 13, 2026

Add missing Widget of the Week videos to widget API docs flutter/flutter#191070

Merged

10 tasks

piedcipher marked this pull request as ready for review August 13, 2026 20:45

gemini-code-assist Bot reviewed Aug 13, 2026

View reviewed changes

Piinks reviewed Aug 13, 2026

View reviewed changes

piedcipher marked this pull request as draft August 13, 2026 21:02

piedcipher force-pushed the fix/191031 branch from d71bb5e to cd717b3 Compare August 13, 2026 21:21

piedcipher marked this pull request as ready for review August 13, 2026 21:34

gemini-code-assist Bot reviewed Aug 13, 2026

View reviewed changes

jmagman approved these changes Aug 14, 2026

View reviewed changes

jmagman added the CICD Run CI/CD label Aug 14, 2026

Piinks added triage-design Should be looked at in design triage and removed triage-framework Should be looked at in framework triage labels Aug 17, 2026

piedcipher mentioned this pull request Aug 17, 2026

Add missing Widget of the Week videos to widget API docs flutter/flutter#191031

Closed

piedcipher added 8 commits August 19, 2026 17:49

Update nav_bar.dart

51924d2

Update badge.dart

c3f3152

Update carousel.dart

0b442f3

Update search_anchor.dart

43b2189

Update segmented_button.dart

483c79f

Update CHANGELOG.md

24732e2

Update pubspec.yaml

f9df3b3

Update CHANGELOG.md

9b29f7c

piedcipher added 11 commits August 19, 2026 17:49

Update pubspec.yaml

f8a68c4

Update search_anchor.dart

db8f0e7

Update segmented_button.dart

9e51d9a

Update carousel.dart

e401a9f

Update badge.dart

29ff0e5

Update nav_bar.dart

1730ff4

Update CHANGELOG.md

6cc4a0c

Update CHANGELOG.md

7c903ef

Update pubspec.yaml

28c5120

Update pubspec.yaml

b30bb16

Add pending changelogs for missing Widget of the Week videos in cuper…

7f00da9

…tino_ui and material_ui

Piinks force-pushed the fix/191031 branch from b8efc82 to 7f00da9 Compare August 19, 2026 22:49

Piinks reviewed Aug 19, 2026

View reviewed changes

Comment thread packages/material_ui/pending_changelogs/change_2026_08_13_missing_wotw_links.yaml Outdated

Update packages/material_ui/pending_changelogs/change_2026_08_13_miss…

fa31377

…ing_wotw_links.yaml

Piinks approved these changes Aug 19, 2026

View reviewed changes

Piinks added the autosubmit Merge PR when tree becomes green via auto submit App label Aug 19, 2026

auto-submit Bot removed the autosubmit Merge PR when tree becomes green via auto submit App label Aug 19, 2026

Piinks reviewed Aug 20, 2026

View reviewed changes

Comment thread packages/cupertino_ui/pending_changelogs/change_2026_08_13_missing_wotw_links.yaml Outdated

Update packages/cupertino_ui/pending_changelogs/change_2026_08_13_mis…

613d6a0

…sing_wotw_links.yaml

Piinks added the autosubmit Merge PR when tree becomes green via auto submit App label Aug 20, 2026

auto-submit Bot merged commit 59f4145 into main Aug 20, 2026
13 checks passed

auto-submit Bot deleted the fix/191031 branch August 20, 2026 20:03

engine-flutter-autoroll mentioned this pull request Aug 21, 2026

Roll Packages from 1785501174f3 to 252bb33ad366 (6 revisions) flutter/flutter#191480

Merged

Navigation Menu

Uh oh!

[material_ui] [cupertino_ui] Add missing Widget of the Week videos to widget API docs - #12468

[material_ui] [cupertino_ui] Add missing Widget of the Week videos to widget API docs#12468
auto-submit[bot] merged 21 commits into
mainfrom
fix/191031

piedcipher commented Aug 13, 2026 •

edited

Loading

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

Piinks left a comment

Uh oh!

piedcipher commented Aug 13, 2026

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

jmagman left a comment

Uh oh!

Uh oh!

Piinks left a comment

Uh oh!

auto-submit Bot commented Aug 19, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

piedcipher commented Aug 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Pre-Review Checklist

Footnotes

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Piinks left a comment

Choose a reason for hiding this comment

Uh oh!

piedcipher commented Aug 13, 2026

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

jmagman left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Piinks left a comment

Choose a reason for hiding this comment

Uh oh!

auto-submit Bot commented Aug 19, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

piedcipher commented Aug 13, 2026 •

edited

Loading